.. _`Randomized Parameter Search`:

.. _`org.sysess.sympathy.machinelearning.randomized_parsearch`:

Randomized Parameter Search
```````````````````````````

.. image:: random_hyperparam.svg
   :width: 48


Randomized search on hyper parameters.




Documentation
:::::::::::::

Performs a randomized parameter search returning scores and best model found. Uses table as
a "hypercube" of parameters to sample from. Not all parameter combinations are tested, but
rather a fixed number of parameter settings is sampled from the specified distributions. All
combinations of parameters from all columns have equal chance of beeing sampled. Use masked
values for parameter/columns with different lengths.


Definition
::::::::::


Input ports
...........

    **in-model**
        | Type: model
        | Description: in-model
    **parameter space**
        | Type: table
        | Description: param-space
    **X**
        | Type: table
        | Description: X
    **Y**
        | Type: table
        | Description: Y
    **cross-validation**
        | Type: [(table,table)]
        | Description: cross-validation
        | Optional number of ports: 0--1 (default: 0)
        

Output ports
............

    **results**
        | Type: table
        | Description: results
    **parameters**
        | Type: table
        | Description: parameters
    **out-model**
        | Type: model
        | Description: out-model



Configuration
.............

    **Cross validation splits** (cv)
        Number of fold in the default K-Fold cross validation. Ignored when cross-validation port is given
    **iterations** (n_iter)
        Number of randomized searches done













Implementation
..............

.. automodule:: node_paramsearch
    :noindex:

.. class:: ParameterSearch_Randomized
    :noindex: